home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / doom / dme4bt13.zip / DEMOS.TXT < prev    next >
Text File  |  1995-04-02  |  6KB  |  123 lines
  1. All about Demos for DMapEdit
  2. ----------------------------
  3.  
  4. Hopefully you've already seen the old demo I made with beta 6.  If not, 
  5. well..
  6.  
  7. Demo files for DMapEdit have the extention '.rec', which stands for 
  8. recording.  By default, DMapEdit will use 'demo.rec' if you don't give 
  9. it a filename.  To play a demo file, you use the '-play' switch:
  10.  
  11. dmapedit -play           <-- playback the demo.rec file
  12. dmapedit -play doors     <-- playback the doors.rec file
  13.  
  14. With a demo running, the word 'demo' will flash in the upper left-hand 
  15. corner of the screen just under the toolbar.  This is just there to 
  16. remind you a demo is playing.  During playback, all control functions 
  17. (mouse and keyboard) are read from the demo file, instead of you the 
  18. user.  You can stop playback at any time by pressing 'ESC'.
  19.  
  20. During playback, windows will most likely appear from time to time
  21. containing information for you to read.  This is to explain what the
  22. 'demo' is doing.  With demo mode, I wanted to try and make it so that I 
  23. could show each and every user of DMapEdit how to use my editor, without 
  24. actually having to be there to show you myself.  If I was there teaching 
  25. you how to use it, I would talk to you and tell you exactly what I'm 
  26. doing as I do it.  Since I'm not really there, though, these windows 
  27. serve that purpose.
  28.  
  29. I call these windows 'info boxes'.  When an info box appears, DMapEdit 
  30. will wait until you read it all.  When you are done reading it, all you 
  31. need to do is press any key on the keyboard to continue, except 'ESC', 
  32. since this will stop playback.
  33.  
  34. Playback will automatically end when the end of the demo file being 
  35. played is reached, or when DMapEdit terminates.  In the first case, an 
  36. info box will appear informing you that the demo is at an end.  You will 
  37. once again have full control of DMapEdit at this point.
  38.  
  39. ---------------
  40. Recording Demos
  41. ---------------
  42.  
  43. In addition to simply being able to play demos, you can also record your 
  44. own demos.  This can be useful for many reasons:
  45.  
  46. * Someone you are trying to explain something to can't make heads or 
  47.    tails of what you are saying, and you can't get together with him/her 
  48.    to actually show them.  An example is worth 10,000 words. (Just a 
  49.    simple picture is only worth 1,000!)  You can create a demo for them 
  50.    to explain it all.
  51.  
  52. * You've found a bug in DMapEdit that you can reproduce at will, but 
  53.    can't seem to explain the bug to me very well.  You can create a demo 
  54.    that demonstrates the error happening.
  55.  
  56. * You can create a tutorial on DMapEdit usage, or on how to create a 
  57.    PWAD from start to finish, or whatever.  Beats reading a big long file.
  58.  
  59. As you can see, the common theme here is 'DEMOnstrating' your ideas in 
  60. real time.  Ok, so how do you do it?
  61.  
  62. Basically, you follow the same format for playing a demo, except you use 
  63. the '-record' switch:
  64.  
  65. dmapedit -record           <-- record the demo.rec file
  66. dmapedit -record doors     <-- record the doors.rec file
  67.  
  68. Please note however that this will erase whatever file already exists 
  69. with that name, overwritting it with your new demo.  If you want to 
  70. append to an existing demo, see below.
  71.  
  72. Once DMapEdit is up and running, all mouse and most keyboard commands 
  73. are automatically saved as you go along.  The reason I say most keyboard 
  74. commands is that currently only normal keys and Alt-keys are saved.  
  75. Holding down the Shift or Ctrl key when using the mouse buttons will not 
  76. save properly.  Only the fact that the mouse button was pressed will be 
  77. saved, so playback will react differently from your recording if you do 
  78. this.  I will correct this later when I come up with a good solution.
  79.  
  80. The word 'recording' will flash in the upper left-hand corner of the 
  81. screen just below the toolbar to remind you that it is recording a demo.
  82.  
  83. "So what about the info boxes?" you are probably asking.  When you are 
  84. ready to have an info box display, simply press the ` key (not the ' key!),
  85. which should be located just below the 'ESC' on most keyboards.  This 
  86. will pop up a big empty window for you to put your message in.  It's not 
  87. the world's greatest editor or anything, but it does support cursor 
  88. movement, insert, delete, page up/down, home, end, and word-wrap.  If 
  89. you find what you want to say is more than will fit in the window, put 
  90. it into 2 windows instead, one right after the other.
  91.  
  92. When you are done typing in your message to the user, pressing 'ESC' 
  93. will save the window and let you continue where you left off.  A word of 
  94. warning, however.  Info boxes are really only meant to be displayed from 
  95. the 'main editing loop'.  This would be were you actually dealing with 
  96. the map directly.  Basically, if any type of yellow window is displayed, 
  97. you are not in the main editing loop, and you shouldn't bring up an info 
  98. box there.  While I thought I coded it to work at such points, it 
  99. doesn't seem to, so until I can get it working at such points, avoid 
  100. using it there.  Back out of the windows first to the main editing loop 
  101. first.  'ESC' will work just fine to get you out of the windows, by the 
  102. way.  Using 'ESC' in the main editing loop, however, will stop recording 
  103. of the demo, instead of quitting DMapEdit, which 'ESC' normally does 
  104. when not in Demo mode.
  105.  
  106. Ok, so that about covers everything, right?  Well, there's a few more 
  107. things you might be interested to know about..
  108.  
  109. While you are playing a demo, you can at any point switch over to 
  110. recording mode by pressing 'Alt-R'.  This can be very handy to pick up 
  111. where you left off on a demo you started but didn't finish for whatever 
  112. reason (got sleepy, ran into a bug, power failure, etc.)  This is in 
  113. fact the reason I put it in.  I got tired of having to start all over 
  114. from scratch each time I ran into a bug, or didn't like the direction I 
  115. took with what I was doing and wanted to rewrite it.  Once you are in 
  116. recording mode, however, there is no way to switch back to playback 
  117. again or anything.  Anything else that was in the demo beyond your 
  118. 'take-over' point is history.
  119.  
  120. If you happen to create any really good demos, feel free to send it to 
  121. me.  I'll add it to the library of demos I distribute with DMapEdit, as 
  122. well as the official DMapEdit homepage.
  123.